What's in this PR

Adds a new sample: samples/mcs-policy-agent-topics — Policy Agent (Topic-Based Grounding) for Microsoft Copilot Studio.

A Custom Engine Agent that uses topic-based grounding — each policy domain (HR, Finance, IT Security, Legal & Compliance, Operations & Administration) maps to its own SharePoint folder and its own agent topic. This gives deterministic routing and per-domain precision instead of relying on a single generic search.

Contents

• README.md — problem statement, architecture, sample prompts, deployment steps
• assets/sample.json — PnP sample gallery metadata (with demo video thumbnail)
• src/ — Copilot Studio agent source (.mcs.yml):
  • agent.mcs.yml, settings.mcs.yml
  • knowledge/ — per-domain SharePoint knowledge sources (Finance, HR, IT Security)
  • topics/ — per-domain topics (Finance, HR, ITSecurity, LegalCompliance, OperationsAdministration) plus the standard system topics (Greeting, Fallback, Search, Signin, …)

Notes

• Sample was exported from Copilot Studio using the VS Code extension (.mcs.yml source format).
• All tenant-specific SharePoint URLs are replaced with contoso.sharepoint.com placeholders — reviewers can confirm via the diff.
• Demo video is embedded in the README via a GitHub user-attachments URL.
• I have signed the Microsoft CLA.

Checklist

• One sample per PR (per CONTRIBUTING.md)
• README.md present at sample root
• assets/sample.json present
• No secrets or tenant-specific values committed
• Static screenshot in assets/ — to be added; demo video link included in the meantime